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USING THIS MANUAL 


Tne MAX Reference Manual is a compact, but complete 
description of the MAX language. Experienced prcgremmers may 
turn to this Manual immediately to learn the details cf all 
MAX procedures. 


All MAX procedures are summarized es well as used in a 
format statement which demonstrates the use of the 
procedure. In these statements we have adopted certain 
Simple conventions. Examine the following: 


ln chan = ALLOCATE; 


Upper case is used to indicate XPL/4 or MAX reserved words 
(ALLOCATE). Lower case is used to indicate variables or 
rumbers supplied by the user (in, chan). The meaning of user 
variables is defined in the summery paragraph above each 
format statement. The expressicn 1n always means linenumnber. 


Note also that in every case except one the values either 
passed or returned in MAX prcecedures are FIXED point values. 
The single FLOATING point exception is the octave-point . 
pitch-class argument accepted in the PCH frequency 
conversion function (see page 11). 


SYSTEM OPERATION 
XPL/4 MONITOR 


The standard XPL/4 monitor is used to manage MAX files and 
to compile and run MAX programs. The XPL/4 monitor is 
basically the same as the SCRIPT monitor, except that where 
the SCRIPT monitcr CCNVERTS and PLAYS SCRIPT compositions, 
the XPL/4 moniter COMPILES and RUNS XPL or MAX pregrams. The 
file management commands are idertical with either moniter. 
See the SCRIPT Reference Manual for a summary of these 
commands. 


XPL/4 Performance Commands 


RUN The RUN command compiles and initiates 
execution of a MAX program or composition. 


COMPILE The COMPILE command translates the MAX program 
into a form which is immediately ready for 
execution. The compiled form of the program replaces 
the current file; the current file name is 
changed by the monitor by adding a period (.) 
to the end of the current file name. The compiled 
program may be saved on the user diskette 
by use of the SAVE command. The RUN conmmard may 
be used to execute a compiled program. 


MAX USER DISKETTES 


MAX user diskettes contain the three sections of the MAX 
library in two ferms: the compacted version (MAXSYN, MAXIO, 
MAXTASK) and the scurce version (MAXSYN1, MAXIO1, MAXTASK1). 
The compacted version has had all comments ard line numbers 
removed for faster compilation. The source version has many 
comments and can be listed and modified by the user. 


MAX user diskettes also contain fifteen demonstration 
programs, as well as system file .STAB-4. All these files 
are stored on a Single MAX user diskette with one exception. 
For users of single density 5 1/4 diskettes, the files have 
been stored on four separate diskettes as follows: 


a. User Diskette #1 ~ MAXSYN, MAXIO, and MAXTASK and Demoi-Demo10 
b. User Diskette #2 - MAXSYN, MAXIO, and MAXTASK and Demo11—Demo14 
ce. User Diskette #3 - MAXSYN, MAXIO, and MAXTASK and Demo15 

d. Source Diskette - MAXSYN1, MAXIO1, and MAXTASK1 


Creating New Max User Diskettes 


You can use the XPL/4 FORMCOPY utility program to format a 
new blank diskette and to duplicate a MAX user diskette onto 
it. Instructions may be found in the Scientific XPL/4 
Documentation Update. Sl al 


You will probably wish to UNSAVE the demonstration exemples 
as well as the MAX source files on one copy of your MAX user 
diskette before using it as a master diskette. 


If you use minidiskettes, you may also wish to UNSAVE one or 
all of the compacted MAX files on certain of your user 
diskettes to free up extra space for your own compositions. 
In this case, when you run your MAX composition, the monitor 
will ask you to insert a diskette which contains the file(s) 
specified in the INSERT statement(s) into the right-hand 
drive during compilation. Swapping diskettes in this way is 
time-consuming, but may save crucial space on a 
minidiskette. 


If you have a maxidiskette system, you may wish to store 
both SCRIPT ard MAX files, as well as other programs, on one 
diskette. There is no problem in doing this (as long as you 
have enough space). To compile and play SCRIPT user files, 
the "hidden" SCRIPT system files, such as .BNKDATA and 
-SCON-4, must be present. 


STRUCTURE OF THE MAX LIBRARY 
There are three secticns to the MAX library. 


MAXSYN This section contains the procedures used for controlling 
te digital syntnesizers, such as frequency control, 
waveform memory loading and selection, frequency mcdulation, 
envelope specification, etc. 


MAXIO This section contains the input and cutput procedures 
for use with the Synclavier (R) II keyboard control unit 
and the pedals. 


MAXTASK This section contains the precedures for creation of 
parallel tasks and processes. 


The sections are included in a MAX program by way of an 
INSERT statement in this form: 


in INSERT 'filename'; 
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MAXSYN PROCEDURES 


MAXSYN procedures provide the user with the means to send 
control ccde to the channels in the digital syntnesizers. 


ALLOCATING A CHANNEL 


The term channel is synonymous with voice. The channels are 
numbered by even numbers starting with 0. For example, the 

channels for an 8=voice system are numbered 0, 2, 4, 6, 8, 

10, 12, and 14. 


The following procedures are related to channel allocation 
and setup. 


ALLOCATE Selects a channel from list of free channels. 
Is passed no arguments. Returns a channel number (chan). 
The MAXSYN initialization ecde creates an 
initial list of free channels which equals the number of 
voices in your system. 


ln chan = ALLOCATE; 


ALLOCATEX A special form of ALLOCATE. Is passed an 
array of channel numbers (channellist). Returns a channel 
number from this list. The zeroeth element in the array 
is the number cf charnel numbers in the list. 
The other elements are the channel numbers. 
This function allows the output from specific channels 
to be directed to particular output jacks in stereo 
or quad systems. 


in chan = ALLOCATEX(channellist); 


FREECHAN Returns a channel number to the list of free channels. 
Is passed a channel number. Is called after usage of 
a channel is completed. 


ln CALL FREECHAN(chan) ; 


CLEANUP Sets all parameters for a channel at zero, thus silencing 
it. Is passed a charnnel number. Also resets the 
wave memory pointer for the channel to select the 
sine wave memory. 


In CALL CLEANUP(chan); 


ZEROSYN Performs a CLEANUP on all channels. 
Is passed no arguments. Is called during MAXSYN 
initialization code to put the synthesizer in a 
known state. 


In CALL ZEROSYN; 


FREQUENCY SPECIFICATION 
Setting the Frequency 


There are two procedures which can be called to set the 
frequency for a channel. In the first the frequency of the 
carrier is directly specified ard the frequency of the 
modulator is specified by way of an FM ratio. In the second 
both carrier and modulator frequency are directly specified. 
Procedures for precalculation and fast emitting are also 
available. 


SETFRQ Calculates 24-dit frequency descriptor and emits 
it to the synthesizer channel. Is passed channel 
number (cnan), frequency number (freq.num), and 
ratio. The frequency number is a value returned 
from any of the four conversion functions described 
below. The ratio is an integer 1000 times the desired 
FM ratio. a 


ln CALL SETFRQ(chan,freq.num,ratio x 1000); 


SETFRQ2 Calculates 24-bit frequency descriptor and emits it 
to the synthesizer channel. Is passed channel number 
(chan), frequency number for the carrier (carfnum), 
and frequency number for the medulator (modfnum). 
The frequency numbers are values returned from 
any of the four functions. 


In CALL SETFRQ2(chan ,carfnun,modfnum) ; 

CALCFRQ Calculates 24-bit frequency descriptor and stores it 
in glooal variables NOTEADD, NOTEDIV, and NOTEINC. 
Is passed frequency rumber from ore of the four 
conversion functions. 


ln CALL CALCFRQ(freq.num); 
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EMITEFROQ Emits carrier frequency to synthesizer charret. Is passe 
channel number ard NOTEADD, NOTEDIV, and HOTEINC. 


In CALL EMITEFRG(chan,NOTEADD,NOTEDIV,NOTEINC) ; 


EMITIFRQ Emits modulator frequency tc syrthesizer channel. Is 
passed channel number and NOLEADD, NOTEDIV, ard NOTEINC. 


In CALL EMITIFRQ(chan,NOTEADD,NOTEDIV,NOTEIHC) ; 


Frequency Corversicn Functions 


There are four alternative functicrs for converting 
frequency or pitch irto the internal frequercy code which 
can be used in the SETFRQ procedures. Tne first two specify 
absolute frequencies. The third and fourth are affected by 
calls to SET.TUNING.BASE and by the value stcred in the 
variable OCTAVE.RATIO. 


HERTZ Returns frequency rumber code (freq.num). Is 
passed an integer ten times the frequency in hertz. 


ln freq.num = HERTZ(frequency x 10); 
This function is absolute. 


PCH Returns frequency number ccde. Is passed a FLOATING POINT 
octave-point pitch-class rumber. 
The rumber to tne left of tne decimal indicates the 
octave, the first two digits to the right cf the’ decimal 
indicate the pitch in semitcres above C ard any following 
digits indicate tenths, hundredths, etc., of semitones 
above C. 


* 


ln freq.num = PCH(octave-point pitch-class number); 


For example, PCH(8.00) returns a frequency number code 
equivalent to middle C arc §CH(8.04) returns a frequency 
number equivalent to the © 2bd0ve middle C. 


This function is absolute. It is also the ONLY procedure 
in MAX wnich is passed a FLOATING point value. 


PITCH Returns frequency number code. Is passed a character strirg 
in SCRIPT notaticn. Each picch is indicated by 
a pitch letter followed by 2n optional 
sharp symbol (#) or flat symbol (F) and cctave number 
(1 through 5). Accidental symbols do not affect subsequent 
notes. Octave numbers epply to succeeding notes until 


MW 


a new octave number is ertered after the pitch. The 
default octave is 3. Double and multiple accidentals are 
allowed, 


In freq.num = PITCH('SCRIPT pitch’); 


This function i not absclute. It is affected by 
the tuning base ard octave ratio values. 


KEY Returns frequency number ccde. is passed an integer 
indicating a key number on the Synclavier (R) II keyboard, 
The lowest key (lowest C) on the keyboard is numbered 0. 
The highest is 60. Middle C is ou. 
ln freq.num = KEY(keynumber); 


This function is rot absolute. 
It is affected by the tuning base ard octave ratio 
values. 


Special Tuning 


SET.TUNING.BASE Sets the tuning base. Is passed an integer 
ten times the frequency in hertz. 


In CALL SET.TUNING.BASE(frequency x 10); 
It affects all PITCH and KEY frequency conversions. 
OCTAVE .RATIO A variable in which is stored an 
integer 1000 times the octave ratio. 
The default OCTAVE.RATIO value is 1000. 
ln OCTAVE.RATIO = cetave ratio x 1000; 
This settirg affects all PITCH and KEY frequency 
conversions. 
SETTING THE VOLUME 
SETVOL Places 8-bit value in volume register of 
synthesizer chernel. Is passed a channel number 
and a value between 0 for ro volume to 255 for 


maximum volume. 


In SETVOL(chan,value); 
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SETISHC Emits shift count to irdex interpolator in syntnesizer 
channel. Is passed channel number ard shift court value 
in the range between 0 and 3. The index shift 
count changes the index limit as follows: 

With an index shift count of 0, the irdex limit 

will be as specified in the SETILIM, EMITILIM, 

or SETI statements. with a shift count of 1, 

the index limit will be multiplied by 2. With a 
shift count of 3, the index limit will be multiplied 
by 4 ard with a shift count of 4, the index 

limit will be multiplied by 8. 


ln CALL SETISHC(chan,shiftcountvalue); 


EMITISHC Emits shift count to index interpolator. Is passed 
channel number and shift count value as described 
above. Exactly the same as SETISHC. 


In CALL EMITISHC(chan,shiftcountvalue) ; 


WAVEFORM MEMORIES 


The synthesizer has 32 waveform memories which are shared 
between the channels. One of these memories is preset to 
contain a sine wave. The wave memory pointers for all 
channels are initialized to select this memory. MAXSYN 
provides procedures for-calculating any complex waveform, 
emitting it to cne of the waveform memories, and linking a 
specific waveform memory with a specific channel. 


In the procedures below, the expression harmonic 
coefficients array (harmeoefarray) refers to an array 
containing integers in the range from 0 to 1000 indicating 
the relative amplitudes of the harmcnics. (These numbers - 
correspond to the DIGITALwTONE GENERATORS settings of 0.0 to 
100.0 in the Synclavier (R) II real-time system.) The 
zerceth element in the array indicates the number of 
coefficients specified. 


SETWAVE First checks to see if any waveform memory contains 
desired complex waveform. If so, returns that waveform 
memory number (wavemem#). If not, calculates 
complex waveform, emits waveform array to waveform memory, 
and returns that waveform memory rumber. Is passed 
harmonic coefficients array. Also counts the number 
of current uses of a waveform memory. 


In wavemem# = SETWAVE(harmcoefarray); 
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CALCWAVE Calculates a complex waveform and stores it in t ¢ 256-point 
global array WAVEBUF. Is passed a harmonic coefficients 
array. 


In CALL CALCWAVE(harmcoefarray) ; 

EMITWAVE Emits 256-point waveform array to waveform memory in 
synthesiz >. Is passed wave memory number (wavemem ') 
and waveform array (wavearray). 


In CALL EMITWAVE(wavemem#,wavearray) ; 


FREEWAVE Frees up a usage reference fcr a wave memory. 
Is passed a waveform memory number. 


In CALL FREEWAVE(wavemem# ) ; 


SETWSEL Links channel with wave memory. Is passed 
s channel number and waveform memory number. 


ln CALL SETWSEL(chan ,wavemem#) ; 
EMITWSEL Links channel with wave memory. Is passed channel 


number and waveform memory number. Exactly the same 
as SETWSEL. 


UTILITIES 
The following utility procedures are also included in MAXSYN. 
RND Generates random numbers (randi#). Is passed two integers 
indicating a minimum/maximum range. 
Returns an integer from the minimum to one less 
than the maximum. 
In rand# = RND(min,max); 


The RND function will always produce the same random 
number sequence for each run. 


WAIT Initiates an idle state for the processor 
for a specified period. Is passed a time period 
from 0 to 32,767 milliseconds. 


In CALL \AIT(time) ; 


16 


LOCATE .FILE 


Can be used to search for any file. Is passed a 256-pcint 
array (catbuf) read from sector 0 of diskette ard 

a filename. Returns the starting sector number (sector) 
for the named file, if fourd. 


In sector = LOCATE.FILE(catbuf ,filename) ; 
This funetion is used in the MAXSYN initialization ccde 


to look for data file .STAB-4 on the system 
or user diskette. 
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MAXIO PROCEDURES 
USING SCANDATA 


The major MAXIO precedure, SCANDATA, controls the basic 
communication between the Synclavier (R) II Digital 
Synthesizer and the Synclavier (R) II keyboard unit and 
pedals. It uses the MAX variables described below to store 
input and output data ard acts as the transfer egent between 
these variables and the cutside world. There are eighteen 
input variables and ten output variables. Their remes 
describe either their physical location or label on the 
Synclavier (R) II keyboard unit. It is important to note, 
however, that these variables have no intrinsic meaning. 
They do not function as they do in tne Synclavier (R) II 
real-time system. The function of each variable is entirely 
determined by the MAX program. 


The call to SCANDATA is usually placed within a loop which 
includes a WAIT, or a SUSPEND in multitask programs (see 
MAXTASK), of five milliseconds. This provides real-time 
synchronized response to user input while the program runs. 
The input variables are set by the call to SCANDATA. The 
information contained in them is accessed by the program 
after the call to SCANDATA. On the other hard, the output 
variables are set by the program before the call to 
SCANDATA. 


The other MAXIO procedures offer convenient means to set and 
use the SCANDATA input and output variables. 


INPUT VARIABLES 


Each call to SCANDATA causes a scanning of the keybcard, 
buttons, control knob, ribbon controller if any and pedals 
if any. The results of this scanning operation are written 
in the variables below. 


CLAVIER An array with a 16-bit element for each octave of 
the keyboard. In each element the 12 lower-order 
bits indicate the status of the 12 keys in the octave. 
A zero bit indicates that the key is up, and a 
one bit indicates that the key is down. 


PANSW An array with a 16-bit element for each panel of 
16 buttons on the Synclavier (R) II control panel. 
The zeroeth element in the array is the ENVELOPE panel 
of buttons, the seventh element is the 
RECORDER STORE/RECALL panel of buttons. 
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KNOB. POS 


KNOB. BASE 


KNOB. CHANGE 


RTEPEDAL. POS 


VOLPEDAL. POS 


RIB. ACTIVE 


RIB. BASE 


RIB.POS 


In each element, each bit corresponds to one of the buttons. 
The least significant bit is the upper left button in 

the panel. The most significant bit is the lower right 
button in the panel. A zero bit indicates that the 

button is not pressed. A one bit indicates the button is 
pressed. All pressed buttons are lit by SCANDATA. 


A variable indicating the current position of the control 
knob. When the knob is fully left, the value will te 100. 
When the Knob is fully right, the value will be 16C. 
(These numbers may be different by a few counts on some 
systems.) 


A variable indicating the neutral, centered positior of the 
knob, typically 130. 


A variable that can be added to any parameter in order 
to change the parameter as the user turns the knob. 

It is the filtered and smoothed result of 

KNOB. POS-KNOB.BASE. 


A variable indicating the current position of the 
pedal connected to the jack labeled REAL TIME EFFECTS 
on the back of the Synclavier (R) II keyboard unit. 

A zero is written when the pedal is all the way up 

or turned off. A value of 225 is written when the 
pedal is all the way down. 


A variable indicating the current position of the 
pedal connected to the jack labeled OVERALL VOLUME 
on the back of the Synclavier (R) II keyboard unit. 
A zero is written when the pedal is all the way up 
or turned off. A value of 225 is written when the 
pedal is all the way down. 


A variable indicating whether the ribbon controller is 
active (pressed) or not. The value is 1 when the ribbon is 
active, and 0 if not. 


If active, the following two variables will also be set: 


A variable indicating the place on the ribbon that was 
first pressed. The range is from 15 for the left end 

to 200 for the right end. (As with the knob, these 
numbers may be different by a few counts on some systems.) 


A variable indicating the place on the ribbon that is 
currently being pressed. The range is 15 to 200 as 
above. 
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PBI.POS 


PBI. BASE 


HOLD. SWITCH 
REP. SWITCH 
GLIDE .SWITCH 
SUST. SWITCH 
ARP. SWITCH 
PUNCH. SWITCH 


OUTPUT VARIABLES 


A variable determined by the -yoltage of the pitch bend 
input. The range is from 107- <A 128 when a = is 
connected to the input, but may be a wider rang 

for other devices. 


A variable determined by the voltage of the pitch bend 
input at initialization time. 

(For proper results, the pitch bend input device should be 
at its neutral position at initiation time.) 


Variables indicating values for the input switches. 
They correspond to the HOLD, REPEAT, PORTAMENTO, 
SUSTAIN, ARPEGGIATE, and PUNCH IN/OUT input jacks 

on the back of the Syrclavier (R) II keyboard unit. 
The value is 1 if the switch is connected and clcsed; 
otherwise, it is 0. 


The output variables are used by SCANDATA to represent data 
leaving the system. The user sets these variables befcre the 
call to SCANDATA. 


DISPLAYSW 


DIGDISPLAY 


GATE .OUT 
TRIGGER . OUT 
CV.OUT 
RIBBON . OUT 
HPFILT.OUT 
BPFILT.OUT 
LPFILT.OUT 
BANDWIDTH.OUT 


An array which indicates which buttons on the control 
panel are to be lit. The elements in the array are 
formatted in the same way as in PANSW. A 1 bit 
causes the button to be lit. A zero bit indicates 
the button will be turned off. 


An array which indicates the elements of the LED 
which are to be lit. The user should call the 
Special DISPLAY precedure described below to 

set up this array. 


Variables which prcduce control voltage outputs 

from the 8-bit DAC's on the back of the Synclavier (R) II 
keyboard unit. They correspond to the jacks labeled 
KEYBOARD GATE, KEYBOARD TRIGGER, KEYBOARD CV, 

RIBBON, HIGH PASS, BAND PASS, LOW PASS, 

and BANDWIDTH. The coding is such that a value of 

zero preduces zero volts and a value of 255 produces 

10.4 volts. 
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SPECIAL PROCEDURES 


There are four procedures which aid in setting or using the 
variables associated with SCANDATA. 


DISPLAY 


DISPLAY. ERROR 


SCAN ..KEYBOARD 


SCAN. RELEASE 


Sets up the DIGDISPLAY variables so that the 

LED will display a value with a decimal 

point and one of the units lights to the right of 
the display will be lit. Is passed a value 

from 0 to 9999, an integer (decpos) indicating 

the number of digits to the right of the decimal point, 
and a units code (units). This units code is 1 for 
MILLISECONDS, 2 for HERTZ, 4 for ARBITRARY, 

and 8 for DECIBELS. More than one units light can 

be lit by adding the codes for each light desired. 
This procedure is called before the call to SCANDATA. 


ln CALL DISPLAY(value ,decpos,units); 


A special case of DISPLAY used for error messages. 

Is passed a value between 0 and 9 and sets up 
DIGDISPLAY variables to show ErrO through Err9. 

This procedure is called before the call to SCANDATA. 


ln CALL DISPLAY.ERROR (value) ; 


Returns the number (numkeys) of keys depressed 

Since the last call to SCAN.KEYBOARD as well as 

their key numbers. Is passed an array (list) 

in which key numbers will be placed, starting 

with the zeroeth element. Is also passed a 

maximum size for the array (listsize). 

The size of the array determines how many new keys 
can be detected at one time. 

If no new keys have been depressed, the number 
returned (numkeys) will be zero. This procedure is called 
after the call to SCANDATA and uses the CLAVIER array. 


ln numkeys = SCAN.KEYBOARD(list ,listsize); 

Similar to SCAN.KEYBOARD. Returns the number (numkeys) 
of keys released since the last call to SCAN.RELEASE 
as well as their key numbers. Is passed and returns 
arguments exactly like SCAN.KEYBOARD. This procedure 
is called after SCANDATA. 


ln numkeys = SCAN.RELEASE(list ,listsize); 
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MAXTASK PROCEDURES AND STATEMENTS 
MAXTASK allows the creation of parallel processes and 
multiple simutaneous events. Each event is defined as a 
task. 
TASK DEFINITION 


A task resembles a regular procedure with a few exceptions. 
The first line in the task takes this form: 


ln taskname: PROCEDURE; 

There can be no argument list associated with the task. 

The last line in the task takes this form: 

ln END taskname; 

If there are to be several copies of a task active at once, 
local variables must be declared AUTOMATIC, tc make them 
local to each individual task. 

The AUTOMATIC type declaration takes this form: 

ln DCL variablename AUTOMATICn; 

where n is a number 1 through 6. Up to six variables may be 
declared AUTOMATIC within a task. Due to the nature in which 


AUTOMATIC variables are stored, they may not be used as 
indices cf DO loops. Use a direct IF-THEN-GOTO loop. 


THE MAIN TASK 


There must be one primary task called MAIN. It is named just 
after the INSERT statements in the following way: 


ln MAIN: PROCEDURE; 
The last line in the program should be: 


ln END MAIN; 
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STARTING, STOPPING AND SUSPENDING TASKS 
A task is begun by means of a START statement in this form: 
in START taskname TASK; 


The MAIN task is started |y the MAXTASK initialization code, 
All other tasks are started from within the MAIN task. 


An optional SET clause may be inserted in the START 
statement to set values for the AUTOMATIC variables of the 
named task. This START statement takes this form: 

In START taskname SET(v1,v2,v3,v4,v5,v6) TASK; 

where v1 through v6 are values to be stored in the six 
AUTOMATIC variables. All six values must appear even if 
there are not six AUTOMATIC variables. 


A task may stop itself by a TERMINATE statement in this 
form: 


ln TERMINATE TASK; 
This is the normal ending of a task. 


A task may stop another task by a KILL statement in this 
form: 


ln KILL taskname TASK; 

A task may suspend itself and go into an idle state for a 
specified length of time, thus giving other tasks a chance 
at the processor. The SUSPEND statement takes this form: 

In CALL SUSPEND(time) ; 

Time is specified in milliseconds. Do not call SUSPEND with 
a time of less than five milliseconds (one clock tick). The 


SUSPEND procedure should be used instead of the WAIT 
procedure when you are using multiple tasks. 


24 


ERROR MESSAGES 
The MAXTASK error messages are summarized here. 


Error1: Too meny tasks active. The default limit is 18. This 
limit may be expanded by increasing the value in the 
NUM.TASKS declaration in the MAXTASK s-curce code. 


Error2: Error in starting of task. The START statement has 
an inecrrect format. 


Error3: Stack length exceeded. Correct this problem by 
increasing the value in the LEN.STACK declaration in the 
MAXTASK source ccde. Refer to the Scientific XPL/4 Reference 
Manual for more information on push down stack requirements 
CPDL) . 


Error4: All tasks terminated. This error is generated when 
all tasks have been terminated. This may be a normal result 
in some instances. 


Errer5: Error in killing of task. The KILL statement has an 
incorrect format. 
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PROBLEM SOLVING 


The XPL/4 compiler provides arn excellent set of diagnostic 
messages, and will point out the location of an error. The 
compiler, nowever, is unaware of the special constructs and 
variables of MAX and cannot tailor messages especially for 
the MAX user. 


The most common error is accidental usage of a variable 
identifier which has already been used in the MAX source 
code, for example CLAVIER or KEY. To help prevent the user 
from acciaentally nitting on MAX words, 211 internal MAX 
variables have been given names containing pericds and/or 
section prefixes, such as OLD.CLAVIER.K, 
MAXSYN.CLOCK.DIVISOR, or MT.TIME. 


Do not use the words LOAD, MUL, ADD, or DIV, as these are 
part of the MAXSYN instructions for the hardware 
multiply/divide board. 


For problems related to operation of the computer terminal, 
refer to the problem solving section in the SCRIPT 
documentation. 


Remember that if you include the MAXIO section cf the 
library, you must have a Synclavier (R) II keyboard unit 
connected to the system. If problems in execution occur when 
you have included MAXIO, first check the keyboard unit 
connections. 


ar 


